Informática Multimedia 1995 April

home *** CD-ROM | disk | FTP | other *** search

/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILE_CHG / PC_ZAP20.ZIP / PC-ZAP20.DOC < prev next >

Wrap

Text File | 1980-01-01 | 150.1 KB | 3,763 lines

PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide VersionVersionVersionVersion 2.02.02.02.0 forforforfor thethethethe IBMIBMIBMIBM PCPCPCPC January 1984 Pelt Industries 121 Buckingham Drive, #55 Santa Clara, CA 95050 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide Second______SecondSecondSecond_Edition_______EditionEditionEdition_-_---_January_______JanuaryJanuaryJanuary_1984____198419841984 Changes are periodically made to the information herein; before using this publication consult with Pelt Industries for any changes or updates. (C) Copyright 1983 Markus Pelt. PC-ZAP User's Guide Version 2.0 for the IBM PC ii PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide PREFACE_______PREFACEPREFACEPREFACE PC-ZAP is a utility program for the IBM PC and PC/XT which allows easy modification of any DOS file (typi- cally a .COM or .EXE file) without the use of the DOS DEBUG command. This document explains the use of the PC-ZAP program and how to create ZAP files. PC-ZAP can: o dump a file in hexadecimal and ASCII dump format o verify data in a file, and o replace data in a file THE___THETHETHE_PI-WARE_______PI-WAREPI-WAREPI-WARE_CONCEPT_______CONCEPTCONCEPTCONCEPT If you are using this program and finding it of value, your contribution ($35 suggested) will be appreciated. Pelt Industries 121 Buckingham Drive, Suite 55 Santa Clara, CA 95050 You are encouraged to copy and share this program with other users on the conditions that the program is not distributed in modified form, that no fee or consider- ation is charged, and that this notice is not bypassed or removed. HOW___HOWHOWHOW_TO__TOTOTO_USE___USEUSEUSE_THIS____THISTHISTHIS_PUBLICATION___________PUBLICATIONPUBLICATIONPUBLICATION This document is divided into the following chapters: o "Chapter 1. Introduction" on page 1 discusses the operation of the PC-ZAP program, how to start it, run it, and terminate it. o "Chapter 2. Program Operation" on page 6 discusses the PC-ZAP command syntax, how to create zap files, and operation of the program in interactive mode. o "Chapter 3. Reference" on page 12 provides a ref- erence of the PC-ZAP commands. Commands are list- ed in alpabetical order and a quick reference summary page is provided at the end of the chap- ter. Preface iii PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide RELATED_______RELATEDRELATEDRELATED_PUBLICATIONS____________PUBLICATIONSPUBLICATIONSPUBLICATIONS o OS/VS2_______Service_________Aids____ (IBM order number GC28-0674) describes the operation of the AMASPZAP utility program for the System/370 mainframe computers. PC-ZAP was designed to emulate the functions of this IBM utility. This is an IBM technical refer- ence manual and as such is not recommended for the novice user. CHANGES_______CHANGESCHANGESCHANGES_WITH____WITHWITHWITH_PC-ZAP______PC-ZAPPC-ZAPPC-ZAP_RELEASE_______RELEASERELEASERELEASE_2.0___2.02.02.0 The following enhancements and fixes have been included in release 2.0 of PC-ZAP: o The BASE command has been added. o The DUMP command has been rewritten to improve performance. o The documentation has been rewritten in its entirety. o Additional sample zaps have been added to the sam- ples in "Appendix B. SAMPLE ZAP FILES" on page 31. Preface iv PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide CONTENTS________CONTENTSCONTENTSCONTENTS ChapterChapterChapterChapter 1.1.1.1. IntroductionIntroductionIntroductionIntroduction .... .... .... .... .... .... .... .... .... .... .... .... .... .... 1111 Distribution package . . . . . . . . . . . . . . . 1 Distribution Diskette . . . . . . . . . . . . . . 1 PC-ZAP.EXE program . . . . . . . . . . . . . . 1 PC-ZAP.DOC document . . . . . . . . . . . . . . 2 Sample ZAP files . . . . . . . . . . . . . . . 2 READ.ME file . . . . . . . . . . . . . . . . . 2 System Requirements . . . . . . . . . . . . . . . 2 Printing the Documentation . . . . . . . . . . . 2 Starting up the program . . . . . . . . . . . . . . 3 Ending the program . . . . . . . . . . . . . . . . 4 ChapterChapterChapterChapter 2.2.2.2. ProgramProgramProgramProgram OperationOperationOperationOperation .... .... .... .... .... .... .... .... .... .... .... 6666 PC-ZAP Command . . . . . . . . . . . . . . . . . . 6 Function . . . . . . . . . . . . . . . . . . . 6 Syntax . . . . . . . . . . . . . . . . . . . . 6 Examples . . . . . . . . . . . . . . . . . . . 7 Notes . . . . . . . . . . . . . . . . . . . . . 7 Zap files . . . . . . . . . . . . . . . . . . . . . 8 Order of Commands . . . . . . . . . . . . . . . . 8 Uses of the VER statement . . . . . . . . . . . . 8 The NOGO switch . . . . . . . . . . . . . . . . . 9 Multiple zap files . . . . . . . . . . . . . . 10 Notes . . . . . . . . . . . . . . . . . . . . . 10 Interactive Mode . . . . . . . . . . . . . . . . 10 Ctrl-Break . . . . . . . . . . . . . . . . . . 11 ChapterChapterChapterChapter 3.3.3.3. ReferenceReferenceReferenceReference .... .... .... .... .... .... .... .... .... .... .... .... .... .... 12121212 PC-ZAP commands . . . . . . . . . . . . . . . . . 12 BASE Command . . . . . . . . . . . . . . . . . 13 Function . . . . . . . . . . . . . . . . . . 13 Syntax . . . . . . . . . . . . . . . . . . . 13 Examples . . . . . . . . . . . . . . . . . . 13 Notes . . . . . . . . . . . . . . . . . . . . 13 DUMP command . . . . . . . . . . . . . . . . . 14 Function . . . . . . . . . . . . . . . . . . 14 Syntax . . . . . . . . . . . . . . . . . . . 14 Examples . . . . . . . . . . . . . . . . . . 14 END Command . . . . . . . . . . . . . . . . . . 15 Function . . . . . . . . . . . . . . . . . . 15 Syntax . . . . . . . . . . . . . . . . . . . 15 Notes . . . . . . . . . . . . . . . . . . . . 15 NAME Command . . . . . . . . . . . . . . . . . 16 Function . . . . . . . . . . . . . . . . . . 16 Syntax . . . . . . . . . . . . . . . . . . . 16 Examples . . . . . . . . . . . . . . . . . . 16 REP Command . . . . . . . . . . . . . . . . . . 17 Function . . . . . . . . . . . . . . . . . . 17 Syntax . . . . . . . . . . . . . . . . . . . 17 Examples . . . . . . . . . . . . . . . . . . 17 Contents v PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide Notes . . . . . . . . . . . . . . . . . . . . 17 VER Command . . . . . . . . . . . . . . . . . . 18 Function . . . . . . . . . . . . . . . . . . 18 Syntax . . . . . . . . . . . . . . . . . . . 18 Examples . . . . . . . . . . . . . . . . . . 18 Quick Reference Summary . . . . . . . . . . . . . 19 AppendixAppendixAppendixAppendix A.A.A.A. ERRORERRORERRORERROR MESSAGESMESSAGESMESSAGESMESSAGES .... .... .... .... .... .... .... .... .... .... .... 20202020 Types of messages . . . . . . . . . . . . . . . . 20 Recovering from errors . . . . . . . . . . . . . 20 Explanation of Error Messages . . . . . . . . . . 22 AppendixAppendixAppendixAppendix B.B.B.B. SAMPLESAMPLESAMPLESAMPLE ZAPZAPZAPZAP FILESFILESFILESFILES .... .... .... .... .... .... .... .... .... .... 31313131 DISCLAIMER . . . . . . . . . . . . . . . . . . . 31 123.ZAP - Unprotect Lotus 123 . . . . . . . . . . 32 EW.ZAP - Unprotect EasyWriter . . . . . . . . . . 34 FORMATV.ZAP - Make /V default for FORMAT.COM . . 36 GEMGRAPH.ZAP - GRAPHICS.COM for Gemini printers . 38 MS.ZAP - Unprotect MemoryShift . . . . . . . . . 40 PECOLOR.ZAP - IBM Personal Editor color support . 42 PELOGO.ZAP - Bypass IBM Personal Editor Logo . . 45 GlossaryGlossaryGlossaryGlossary .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... 47474747 IndexIndexIndexIndex .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... 48484848 Contents vi PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide LIST____LISTLISTLIST_OF__OFOFOF_ILLUSTRATIONS_____________ILLUSTRATIONSILLUSTRATIONSILLUSTRATIONS Figure 1. Startup messages . . . . . . . . . . . . 4 Figure 2. Exit message . . . . . . . . . . . . . . 5 Figure 3. Original zap . . . . . . . . . . . . . . 9 Figure 4. Switched zap . . . . . . . . . . . . . . 9 Figure 5. Multiple zap file . . . . . . . . . . 10 Figure 6. Sample output from DUMP command . . . 14 Figure 7. Recovery prompt . . . . . . . . . . . 21 Figure 8. PC-ZAP Return Codes . . . . . . . . . 22 List of Illustrations vii PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide CHAPTER_______CHAPTERCHAPTERCHAPTER_1.__1.1.1._INTRODUCTION____________INTRODUCTIONINTRODUCTIONINTRODUCTION DISTRIBUTION____________DISTRIBUTIONDISTRIBUTIONDISTRIBUTION_PACKAGE_______PACKAGEPACKAGEPACKAGE The distribution package for PC-ZAP consists of the following items: 1. The PC-ZAP version 2.0 User's Guide 2. The PC-ZAP version 2.0 distribution diskette Distribution____________DistributionDistributionDistribution_Diskette________DisketteDisketteDiskette The distribution diskette contains information on BOTH____BOTHBOTHBOTH sides. Each side is formatted in single sided format compatible with DOS 1.0, DOS 1.1 and DOS 2.0 using 8 sectors per track (160KBytes per side). Simply flip the diskette over to access the other side. The diskette cannot______cannotcannotcannot be used to boot your system, since it does not contain a copy of the DOS COMMAND.COM pro- gram (due to copyright restrictions). We recommend that you copy the PC-ZAP.EXE file onto another diskette and keep the PC-ZAP distribution diskette as a backup. The programs and data on the diskette are not copy-protected and may be copied freely under the provisions outlined in the "Preface" of this document. The distribution diskette contains the following files: o PC-ZAP.EXE o PC-ZAP.DOC o Sample ZAP files (xxx.ZAP) o READ.ME PC-ZAP.EXEPC-ZAP.EXEPC-ZAP.EXEPC-ZAP.EXE programprogramprogramprogram This program is invoked from DOS command mode. See "PC-ZAP Command" on page 6 for a detailed description of the command operands. Chapter 1. Introduction 1 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide PC-ZAP.DOCPC-ZAP.DOCPC-ZAP.DOCPC-ZAP.DOC documentdocumentdocumentdocument This file contains a copy of the PC-ZAP User's Guide and can be printed on a printer using the DOS PRINT or COPY command. SampleSampleSampleSample ZAPZAPZAPZAP filesfilesfilesfiles Several .ZAP sample files have been included on the distribution diskette to illustrate the use and ease with which zaps can be applied to enhance your exist- ing software. See "Appendix B. SAMPLE ZAP FILES" on page 31 for details on how to apply these ZAPs. READ.MEREAD.MEREAD.MEREAD.ME filefilefilefile This file is a text file which may include addenda and corrections to this manual. Please read this file (by issuing the DOS TYPE command or print it using the PRINT or COPY commands) before continuing to read this manual. See "Printing the Documentation" below for details. System______SystemSystemSystem_Requirements____________RequirementsRequirementsRequirements PC-ZAP requires an IBM PC or PC/XT computer with at least the following: o At least 64K of RAM o DOS 1.0, 1.1 or 2.0. o A floppy disk drive either single or double-sided. A printer is optional and can be used to print the documentation provided on the distribution floppy diskette as well as to print output listing from PC-ZAP runs. PC-ZAP was written in compiled BASIC and supports zap- ping of files on any disk type supported by the DOS operating system under which it runs. Printing________PrintingPrintingPrinting_the___thethethe_Documentation_____________DocumentationDocumentationDocumentation The file PC-ZAP.DOC may be printed on any printer which meets the following criteria. The file may be Chapter 1. Introduction 2 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide viewed on the screen using the DOS TYPE command, although some overprinted lines may not be legible. The printer must meet the following conditions: o Carriage return (decimal 13) must cause the print- er to return to the first column of the current print line. It must not___notnotnot skip to the next line. o Line feed (decimal 10) must cause the printer to advance to the next line. It is not necessary that the printer return the carriage to column one. The paper you attempt to print this document on should be 8.5 by 11 inches. The document is formatted to be printed at 66 lines per inch vertically, 10 characters per inch horizontally. If you should find that the document will not print correctly, check that your printer satisfies the above requirements. STARTING________STARTINGSTARTINGSTARTING_UP__UPUPUP_THE___THETHETHE_PROGRAM_______PROGRAMPROGRAMPROGRAM The PC-ZAP program is distributed on a single sided diskette. To startup the program do the following: 1. MakeMakeMakeMake suresuresuresure youyouyouyou areareareare inininin DOSDOSDOSDOS commandcommandcommandcommand mode.mode.mode.mode. If you have not powered up your IBM PC yet, insert your DOS system disk into drive A (left drive) first and then turn on the power-switch on the right side of the machine. If you have already powered up your IBM PC, termi- nate whatever program you are currently using, to get back to DOS command mode. In either case, you should see one of the follow- ing prompts on the screen, with the cursor flash- ing next to it: +-----------------------------------------------------------------+ | | | A>_A>_A>_A>_ orororor B>_B>_B>_B>_ | | | +-----------------------------------------------------------------+ 2. Insert the PC-ZAP program diskette (or any disk- ette containing file PC-ZAP.EXE into the left drive (drive A) or the right one (drive B), Chapter 1. Introduction 3 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide depending on which prompt is being displayed on the screen. 3. Invoke the PC-ZAP program by typing in: +-----------------------------------------------------------------+ | PC-ZAP;PC-ZAP;PC-ZAP;PC-ZAP; | +-----------------------------------------------------------------+ and then pressing the "ENTER""ENTER""ENTER""ENTER" key. The word "PC-ZAP" may be typed in either upper- or lower- case letters or any combination. 4. After some clicking and whirring you should be presented with the following messages: +-----------------------------------------------------------------+ | OctoberOctoberOctoberOctober 1983198319831983 | | | | PPPP CCCC ---- ZZZZ AAAA PPPP vvvv eeee rrrr ssss iiii oooo nnnn 2.002.002.002.00 | | | | ------------ PI\WAREPI\WAREPI\WAREPI\WARE -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | | IfIfIfIf youyouyouyou areareareare usingusingusingusing thisthisthisthis programprogramprogramprogram andandandand findingfindingfindingfinding itititit ofofofof valuevaluevaluevalue | | youryouryouryour contributioncontributioncontributioncontribution ($20($20($20($20 suggested)suggested)suggested)suggested) willwillwillwill bebebebe appreciated.appreciated.appreciated.appreciated. | | | | | | PeltPeltPeltPelt IndustriesIndustriesIndustriesIndustries | | 121121121121 BuckinghamBuckinghamBuckinghamBuckingham Drive,Drive,Drive,Drive, SuiteSuiteSuiteSuite 55555555 | | SantaSantaSantaSanta Clara,Clara,Clara,Clara, CACACACA 95050950509505095050 | | | | YouYouYouYou areareareare encouragedencouragedencouragedencouraged totototo copycopycopycopy andandandand shareshareshareshare thisthisthisthis programprogramprogramprogram | | withwithwithwith otherotherotherother usersusersusersusers onononon thethethethe conditionsconditionsconditionsconditions thatthatthatthat thethethethe programprogramprogramprogram isisisis notnotnotnot | | distributeddistributeddistributeddistributed inininin modifiedmodifiedmodifiedmodified form,form,form,form, thatthatthatthat nononono feefeefeefee orororor considerationconsiderationconsiderationconsideration | | isisisis charged,charged,charged,charged, andandandand thatthatthatthat thisthisthisthis noticenoticenoticenotice isisisis notnotnotnot bypassbypassbypassbypass orororor removed.removed.removed.removed. | | | | | | (C)(C)(C)(C) CopyrightCopyrightCopyrightCopyright MarkusMarkusMarkusMarkus PeltPeltPeltPelt 1983198319831983 | | | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | | Figure 1. Startup messages | +-----------------------------------------------------------------+ ENDING______ENDINGENDINGENDING_THE___THETHETHE_PROGRAM_______PROGRAMPROGRAMPROGRAM To end the PC-ZAP program you can simply press the "Ctrl-Break""Ctrl-Break""Ctrl-Break""Ctrl-Break" key. If you are using PC-ZAP interac- tively, you can terminate the program by entering "END""END""END""END" whenever you see the "ZAP>" prompt: Chapter 1. Introduction 4 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide +-----------------------------------------------------------------+ | | | ZAP>ZAP>ZAP>ZAP> end_end_end_end_ | | | +-----------------------------------------------------------------+ PC-ZAP will display the following messages when termi- nating: +-----------------------------------------------------------------+ | | | ZAP000IZAP000IZAP000IZAP000I PC-ZAPPC-ZAPPC-ZAPPC-ZAP ENDEDENDEDENDEDENDED ---- RETURNRETURNRETURNRETURN CODECODECODECODE xxxxxxxx | | | | | | Figure 2. Exit message | +-----------------------------------------------------------------+ Chapter 1. Introduction 5 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide CHAPTER_______CHAPTERCHAPTERCHAPTER_2.__2.2.2._PROGRAM_______PROGRAMPROGRAMPROGRAM_OPERATION_________OPERATIONOPERATIONOPERATION PC-ZAP______PC-ZAPPC-ZAPPC-ZAP_COMMAND_______COMMANDCOMMANDCOMMAND FunctionFunctionFunctionFunction The PC-ZAP command is used to invoke the PC-ZAP pro- gram (file name PC-ZAP.EXE) and to specify the initial defaults for the input, output and list files. PC-ZAP uses three files: an inputfile (zap file), an output file (file to be zapped) and listing file (for DUMP command). Defaults are assigned for each file, unless you override them when you invoke the PC-ZAP command: SyntaxSyntaxSyntaxSyntax +-----------------------------------------------------------------+ | | | PC-ZAPPC-ZAPPC-ZAPPC-ZAP infileinfileinfileinfile outfileoutfileoutfileoutfile listfile;listfile;listfile;listfile; | | | +-----------------------------------------------------------------+ where infileinfileinfileinfile is the name of the input file. This may either be the name of a disk file (drive:name.ext), "CON:" or "*". If CON: or "*" is specified or you enter the PC-ZAP command without operands, input commands will come from the keyboard (interactive mode). If a file name is specified the input file must be an ASCII text file con- sisting of single line commands (BASE, NAME, VER, REP, DUMP or END) and any operands. Input lines can be upto 254 characters long and must be terminated by a carriage return/line feed sequence. The end of the file must be indicated by a hexadecmal 1A (Ctrl-Z) byte. outfileoutfileoutfileoutfile is the name of the file to be zapped. This is the initial file to which all VER and REP cards will be applied. A NAME card in the Chapter 2. Program Operation 6 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide input file will override any subsequent VER and REP cards, however. This file must____mustmustmust be the name of an existing file on disk. listfilelistfilelistfilelistfile is the name of the file to which a listing of messages and file dumps will be printed. The list file can be a printer (specify "LPT1:" or "LPT2") or a disk file (specify "drive:name.ext".) If you specify "CON:" or "*" or if you enter the PC-ZAP command with- out this operand, then all such output will be displayed on the console screen. If the list file is not___notnotnot directed to the console, then any lines printed to the list- ing file are also echoed to the console (ex- cept for actual DUMP command output). This allows you to see all error messages. If you enter a semicolon after the last operand (or after the PC-ZAP command itself without operands), any remaining unspecified are defaulted to: PC-ZAP CON: * CON: If you specify less than three operands on the PC-ZAP command, and do not terminate it with a semicolon, you will be prompted for any unspecified operands. ExamplesExamplesExamplesExamples PC-ZAP; PC-ZAP * * LPT1: PC-ZAP * * COM1:; PC-ZAP MS.ZAP MS.EXE The first example, takes all defaults without prompt- ing. The second takes all defaults but routes the run listing to your printer. The third is the same but routes the run listing to the COM1: device. (modem or serial printer hopefully). The last example will take input commands from file MS.ZAP. If this file contains VER or REP commands without a preceeding NAME command, these commands will apply to file MS.EXE. Since only two operands were given in the last example and no trailing semicolon was entered, the user will be prompted for the third operand (run listing). Chapter 2. Program Operation 7 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide NotesNotesNotesNotes For DOS 2.0 users: PC-ZAP was written in BASIC and compiled with the IBM BASIC compiler which does not support path names. You should use the DOS CHDIR command for each drive which you intend to use (prior_____priorpriorprior to issuing the PC-ZAP com- mand) to select the correct directory to be used when PC-ZAP accesses any files from the drive. ZAP___ZAPZAPZAP_FILES_____FILESFILESFILES To invoke PC-ZAP in batch mode, you must first create a zap___zapzapzap__file____filefilefile: an ASCII text file containing commands such as NAME, VER, REP, BASE and DUMP) and comments (starting with an asterisk in column one of a line). Zap files can be created using any editor which can edit standard text files. Sample zap files are included on the PC-ZAP distribution diskette and are listed and discussed in detail in "Appendix B. SAMPLE ZAP FILES" on page 31. Order_____OrderOrderOrder_of__ofofof_Commands________CommandsCommandsCommands The general outline of a zap is: 1. NAME command 2. BASE command 3. VER command(s) 4. REP command(s) All statements are optional. If you do not include a NAME command, the name of the file to be zapped will be taken from the PC-ZAP command. You must have spec- ified a file name for the second operand on the PC-ZAP command in this case. If you do not specify any VER statements, no verification is performed before replacing data (by the following REP commands). If you do not specify any REP commands then only verifi- cation of data takes place (assuming you did include VER statements.) Specifying only a NAME command, will verify the existence of the named file only. Uses____UsesUsesUses_of__ofofof_the___thethethe_VER___VERVERVER_statement_________statementstatementstatement Chapter 2. Program Operation 8 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide The use of the VER command may seem elusive. It is primarily intended to ensure that you do not change the wrong file by accident. VER statements can be used to: o Check the version number of a program to be zapped, by including a VER statement for the appropriate address within the file (an initial- ization message for example). o Check the program code of a program to be zapped. This prevents accidental application of a zap to the same file twice, by checking the code to be changed with a VER statement before replacing the some locations with a REP statement. Although not necssary, it is good practice to include a VER command for each location which is changed by a subsequent REP command. If you follow this practice, you can "undo" a change simply by switching the VER and REP cards. For example: +-----------------------------------------------------------------+ | | | NAMENAMENAMENAME COMMAND.COMCOMMAND.COMCOMMAND.COMCOMMAND.COM | | VERVERVERVER ED8ED8ED8ED8 54686520546865205468652054686520 TheTheTheThe | | VERVERVERVER EDCEDCEDCEDC 49424D49424D49424D49424D IBMIBMIBMIBM | | REPREPREPREP ED8ED8ED8ED8 20202020202020202020202020202020 (blanks)(blanks)(blanks)(blanks) | | REPREPREPREP EDCEDCEDCEDC 202020202020202020202020 (blanks)(blanks)(blanks)(blanks) | | | | | | Figure 3. Original zap | +-----------------------------------------------------------------+ If you decide to change your mind after you have applied the above zap, simply apply the switched zap: +-----------------------------------------------------------------+ | | | NAMENAMENAMENAME COMMAND.COMCOMMAND.COMCOMMAND.COMCOMMAND.COM | | VERVERVERVER ED8ED8ED8ED8 20202020202020202020202020202020 (blanks)(blanks)(blanks)(blanks) | | VERVERVERVER EDCEDCEDCEDC 202020202020202020202020 (blanks)(blanks)(blanks)(blanks) | | REPREPREPREP ED8ED8ED8ED8 54686520546865205468652054686520 TheTheTheThe | | REPREPREPREP EDCEDCEDCEDC 49424D49424D49424D49424D IBMIBMIBMIBM | | | | | | Figure 4. Switched zap | +-----------------------------------------------------------------+ Note that the VER commands should always preceed the REP commands. Chapter 2. Program Operation 9 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide The___TheTheThe_NOGO____NOGONOGONOGO_switch______switchswitchswitch PC-ZAP uses a switch to indicate whether it should continue processing REP commands or not. The NAME (or DUMP command) will reset the NOGO switch (to GO ahead and process REP commands). Any error in a zap (usual- ly caused by a VER command verification failure) will cause the NOGO switch to be set. Any subsequent REP commands will not be processed (rejected with message ZAP091E). This prevents accidental changes being made to a file. Note that VER and REP commands are processed in sequence. For this reason, VER statements should be specified before any REP statements. Multiple________MultipleMultipleMultiple_zap___zapzapzap_files_____filesfilesfiles The NOGO switch can also be used to include multiple zaps into a single file. This is especially handy when you have a zap which differs from one release to another for a program. For example: +-----------------------------------------------------------------+ | | | NAMENAMENAMENAME COMMAND.COMCOMMAND.COMCOMMAND.COMCOMMAND.COM ReleaseReleaseReleaseRelease 2.02.02.02.0 zapzapzapzap | | VERVERVERVER 0EF70EF70EF70EF7 56657273696F6E20322E303056657273696F6E20322E303056657273696F6E20322E303056657273696F6E20322E3030 VersionVersionVersionVersion 2.002.002.002.00 | | REPREPREPREP 0EF70EF70EF70EF7 20202020202020202020202020202020202020202020202020202020 (blanks)(blanks)(blanks)(blanks) | | NAMENAMENAMENAME COMMAND.COMCOMMAND.COMCOMMAND.COMCOMMAND.COM ReleaseReleaseReleaseRelease 1.11.11.11.1 zapzapzapzap | | VERVERVERVER 03D603D603D603D6 56657273696F6E20312E313056657273696F6E20312E313056657273696F6E20312E313056657273696F6E20312E3130 VersionVersionVersionVersion 1.101.101.101.10 | | REPREPREPREP 03D603D603D603D6 20202020202020202020202020202020202020202020202020202020 (blanks)(blanks)(blanks)(blanks) | | | | | | Figure 5. Multiple zap file | +-----------------------------------------------------------------+ If the above zap is applied to DOS 2.0 COMMAND.COM, the first NAME, VER and REP commands will be executed. The second set will fail verification (the VER command will set the NOGO switch and cause the last REP com- mand to be skipped). If the same zap is applied to DOS 1.1 COMMAND.COM, the first set of statements will fail (the first VER command will set the NOGO switch caus- ing all REP commands upto the next NAME command to be skipped). But the second set of statements will be executed correctly. If this zap is applied to any other COMMAND.COM, both VERs will fail and nothing will be changed. The above zap merely replaces the word "Version" with blanks. Chapter 2. Program Operation 10 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide Notes_____NotesNotesNotes You should be careful not to be too succinct when ver- ifying data. The VER statement is the only means to check whether you are applying a zap to the correct file. If unsure, always make a backup copy of the file to be zapped, prior to zapping it. INTERACTIVE___________INTERACTIVEINTERACTIVEINTERACTIVE_MODE____MODEMODEMODE To invoke PC-ZAP in interactive mode, simply enter the PC-ZAP command without any operands. +-----------------------------------------------------------------+ | | | PC-ZAP;PC-ZAP;PC-ZAP;PC-ZAP; | | | +-----------------------------------------------------------------+ In interactive mode, PC-ZAP will prompt you for com- mands by displaying the prompt: +-----------------------------------------------------------------+ | | | ZAP>_ZAP>_ZAP>_ZAP>_ | | | +-----------------------------------------------------------------+ Whenever this prompt is displayed, you may enter another VER, REP, NAME, BASE or DUMP command; termi- nate each line with the "ENTER" key. To terminate PC-ZAP, simply enter the "END" command. Ctrl-Break__________Ctrl-BreakCtrl-BreakCtrl-Break The Ctrl-Break key (hold down the Ctrl key while pressing the key labeled "Scroll Lock/Break") will interrupt any command currently being executed and return the "ZAP>" prompt. You may then type in anoth- er command. The terminate PC-ZAP enter the "END" com- mand (see "END Command" on page 15.) Chapter 2. Program Operation 11 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide CHAPTER_______CHAPTERCHAPTERCHAPTER_3.__3.3.3._REFERENCE_________REFERENCEREFERENCEREFERENCE PC-ZAP______PC-ZAPPC-ZAPPC-ZAP_COMMANDS________COMMANDSCOMMANDSCOMMANDS PC-ZAP can dump, verify and replace data in any DOS file. The commands available are: o DUMP o END o NAME o VER o REP o BASE The following pages discuss each command in detail. Commands are discussed in alpabetical order for easy reference. Chapter 3. Reference 12 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide BASE____BASEBASEBASE_Command_______CommandCommandCommand FunctionFunctionFunctionFunction The BASE command is used to specify the base address for subsequent VER and REP commands. The base address specified on the BASE command is added to the offset of all subsequent VER and REP cards. This allows for offsets to be specified as they appear in assembly or compilation listings. SyntaxSyntaxSyntaxSyntax +-----------------------------------------------------------------+ | | | BASEBASEBASEBASE offsetoffsetoffsetoffset [comment][comment][comment][comment] | | | +-----------------------------------------------------------------+ where offsetoffsetoffsetoffset is the hexadecimal offset to be added to the offsets specified on all subsequent VER and REP commands (until another BASE command is encountered). You must specify an even num- ber of hexadecimal digits for this operand. commentcommentcommentcomment is an optional string of characters sepa- rated from the offset by one or more blanks. ExamplesExamplesExamplesExamples BASE 0100 BASE 0200 Common value for .EXE files NotesNotesNotesNotes Subsequent VER and REP cards may fail if the sum of offset and base value exceeds the size of the file being zapped. Chapter 3. Reference 13 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide DUMP____DUMPDUMPDUMP_command_______commandcommandcommand FunctionFunctionFunctionFunction The dump command will display or print the contents of a file in hexadecimal as well as ASCI 16 bytes per line. SyntaxSyntaxSyntaxSyntax +-----------------------------------------------------------------+ | | | DUMPDUMPDUMPDUMP filespecfilespecfilespecfilespec [comment][comment][comment][comment] | | | +-----------------------------------------------------------------+ where filespecfilespecfilespecfilespec is the name of the file to be dumped. You cannot include a path name, hence only files within the current directory for any partic- ular drive can be dumped. commentcommentcommentcomment is an optional string of characters sepa- rated from the filespec by one or more blanks. ExamplesExamplesExamplesExamples DUMP COMMAND.COM DUMP A:LINK.EXE The format of the dump looks like: ------------------------------------------------------------------- 000000000000000000000000 4D4D4D4D 6A6A6A6A 72727272 01010101 86868686 00000000 10101010 0A-A00A-A00A-A00A-A0 02020202 77777777 01010101 FFFFFFFF FFFFFFFF 6E6E6E6E 0F0F0F0F *Mzr.......w...m.**Mzr.......w...m.**Mzr.......w...m.**Mzr.......w...m.* 000010000010000010000010 4D4D4D4D 6A6A6A6A 72727272 01010101 86868686 00000000 10101010 0A-A00A-A00A-A00A-A0 02020202 77777777 01010101 FFFFFFFF FFFFFFFF 6E6E6E6E 0F0F0F0F *Mzr.......w...m.**Mzr.......w...m.**Mzr.......w...m.**Mzr.......w...m.* 000020000020000020000020 4D4D4D4D 6A6A6A6A 72727272 01010101 86868686 00000000 10101010 0A-A00A-A00A-A00A-A0 02020202 77777777 01010101 FFFFFFFF FFFFFFFF 6E6E6E6E 0F0F0F0F *Mzr.......w...m.**Mzr.......w...m.**Mzr.......w...m.**Mzr.......w...m.* 000030000030000030000030 4D4D4D4D 6A6A6A6A 72727272 01010101 86868686 00000000 10101010 0A-A00A-A00A-A00A-A0 02020202 77777777 01010101 FFFFFFFF FFFFFFFF 6E6E6E6E 0F0F0F0F *Mzr.......w...m.**Mzr.......w...m.**Mzr.......w...m.**Mzr.......w...m.* .... .... .... Figure 6. Sample output from DUMP command ------------------------------------------------------------------- Note:Note:Note:Note: In interactive mode, you may press the Ctrl-Break key to interrupt the DUMP command output. Chapter 3. Reference 14 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide END___ENDENDEND_Command_______CommandCommandCommand FunctionFunctionFunctionFunction The END command is used to terminate PC-ZAP. If used in a zap file, it should be the last command as no subsequent commands in the file will be processed. If this command is not used, an END command is assumed at the end of a zap file. This command is the only means of terminating PC-ZAP when operating in interactive mode. SyntaxSyntaxSyntaxSyntax +-----------------------------------------------------------------+ | | | ENDENDENDEND | | | +-----------------------------------------------------------------+ This command has no operands. NotesNotesNotesNotes The END command will close all files causing all unwritten changes to be recorded to disk. It is possi- ble in interactive mode that you loose changes (REPs) if you turn off your machine (or reboot it) without ending PC-ZAP, as some buffers may not have been writ- ten back to disk yet. To ensure against this, be sure to terminate PC-ZAP and wait for message ZAP000I before turning power off or rebooting your machine. Chapter 3. Reference 15 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide NAME____NAMENAMENAME_Command_______CommandCommandCommand FunctionFunctionFunctionFunction The NAME command is used to specify the name of a file to be zapped. Subsequent VER, REP and BASE cards apply to this file until another NAME command is encount- ered. SyntaxSyntaxSyntaxSyntax +-----------------------------------------------------------------+ | | | NAMENAMENAMENAME filespecfilespecfilespecfilespec [comment][comment][comment][comment] | | | +-----------------------------------------------------------------+ where filespecfilespecfilespecfilespec is the name of the file to be zapped. You cannot include a path name, hence only files within the current directory for any partic- ular drive can be zapped. commentcommentcommentcomment is an optional string of characters sepa- rated from the filespec by one or more blanks. ExamplesExamplesExamplesExamples NAME COMMAND.COM NAME A:LINK.EXE Chapter 3. Reference 16 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide REP___REPREPREP_Command_______CommandCommandCommand FunctionFunctionFunctionFunction The REP command is used to replace data in a file. REP commands are not executed if the "NOGO" switch has been set by a previous VER command, or by a previous REP command which contained an error. The "NOGO" switch is reset by a subsequent NAME or DUMP command. SyntaxSyntaxSyntaxSyntax +-----------------------------------------------------------------+ | | | REPREPREPREP offsetoffsetoffsetoffset datadatadatadata [comment][comment][comment][comment] | | | +-----------------------------------------------------------------+ where offsetoffsetoffsetoffset is the hexadecimal offset within the file where data is to be replaced. If a BASE com- mand was previously specified, its value is added to the offset. You must specify an even number of hexadecimal digits. datadatadatadata is the hexadecimal data which will replace the data in the file at the specified offset (or offset plus base value if a BASE command was used). You must specify an even number of hexadecimal digits for this operand. commentcommentcommentcomment is an optional string of characters sepa- rated from the data by one or more blanks. ExamplesExamplesExamplesExamples REP 00 01 REP 0100 FF3604F4 NotesNotesNotesNotes If the offset or data operands are invalid, the NOGO switch is set, and this REP command as well as all subsequent REP commands (upto the next DUMP or NAME commands) will not be executed. Chapter 3. Reference 17 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide VER___VERVERVER_Command_______CommandCommandCommand FunctionFunctionFunctionFunction The VER command is used to verify the data within the file matches that specified on the VER command. This command is normally used to make sure that subsequent VER cards will be applied to the correct version of a module. One or more VER cards are included in front of the REP cards to verify for specific data. If any of the VER commands fails, the "NOGO" switch is set which precludes any subsequent REP cards from being proc- essed. The "NOGO" switch is reset by a subsequent NAME or DUMP command. SyntaxSyntaxSyntaxSyntax +-----------------------------------------------------------------+ | | | VERVERVERVER offsetoffsetoffsetoffset datadatadatadata [comment][comment][comment][comment] | | | +-----------------------------------------------------------------+ where offsetoffsetoffsetoffset is the hexadecimal offset within the file where data is to be verified. If a BASE com- mand was previously specified, its value is added to the offset. You must specify an even number of hexadecimal digits. datadatadatadata is the hexadecimal data which should match the data in the file at the specified offset (or offset plus base value if a BASE command was used). You must specify an even number of hexadecimal digits for this operand. If the file contents does not match, the NOGO switch is set. commentcommentcommentcomment is an optional string of characters sepa- rated from the data by one or more blanks. ExamplesExamplesExamplesExamples VER 00 01 VER 0100 FF3604F4 Chapter 3. Reference 18 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide QUICK_____QUICKQUICKQUICK_REFERENCE_________REFERENCEREFERENCEREFERENCE_SUMMARY_______SUMMARYSUMMARYSUMMARY Invocation: +-----------------------------------------------------------------+ | | | PC-ZAPPC-ZAPPC-ZAPPC-ZAP infileinfileinfileinfile outfileoutfileoutfileoutfile listfile;listfile;listfile;listfile; | | | +-----------------------------------------------------------------+ Defaults: PC-ZAP CON: * CON: Commands: +-----------------------------------------------------------------+ | | | BASEBASEBASEBASE offsetoffsetoffsetoffset [comment][comment][comment][comment] | | | | DUMPDUMPDUMPDUMP filespecfilespecfilespecfilespec [comment][comment][comment][comment] | | | | ENDENDENDEND | | | | NAMENAMENAMENAME filespecfilespecfilespecfilespec [comment][comment][comment][comment] | | | | REPREPREPREP offsetoffsetoffsetoffset datadatadatadata [comment][comment][comment][comment] | | | | VERVERVERVER offsetoffsetoffsetoffset datadatadatadata [comment][comment][comment][comment] | | | | **** [comment][comment][comment][comment] | | | +-----------------------------------------------------------------+ ZAP file structure: +-----------------------------------------------------------------+ | | | NAMENAMENAMENAME ............ namesnamesnamesnames filefilefilefile totototo bebebebe zappedzappedzappedzapped | | BASEBASEBASEBASE ............ setsetsetset basebasebasebase valuevaluevaluevalue | | VERVERVERVER ............ verifyverifyverifyverify existingexistingexistingexisting datadatadatadata | | .... | | .... | | VERVERVERVER ............ | | REPREPREPREP ............ replacereplacereplacereplace withwithwithwith newnewnewnew datadatadatadata | | .... | | .... | | REPREPREPREP ............ | | ENDENDENDEND quitquitquitquit thethethethe programprogramprogramprogram | | | +-----------------------------------------------------------------+ Chapter 3. Reference 19 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide APPENDIX________APPENDIXAPPENDIXAPPENDIX_A.__A.A.A._ERROR_____ERRORERRORERROR_MESSAGES________MESSAGESMESSAGESMESSAGES TYPES_____TYPESTYPESTYPES_OF__OFOFOF_MESSAGES________MESSAGESMESSAGESMESSAGES Error messages from PC-ZAP start with a 7 character identifier of the form: +-----------------------------------------------------------------+ | | | ZAPxxxz message.............. | | | +-----------------------------------------------------------------+ where 'xxx' is a three digit message number, 'z' is a single character indicating the type of message and 'message' is the error message as described below for each message number. The message type character 'z' can be: IIII - for informational messages, WWWW - for warning messages, EEEE - for error messages, or AAAA - for action messages. Informational_____________InformationalInformationalInformational messages are just that; for your infor- mation only. They do not necessarily indicate an error but are issued as part of normal processing. Warning_______WarningWarningWarning messages may require your attention. They indicate an unusual but not necessarily abnormal condition. Error_____ErrorErrorError messages are definite problems. They indicate that the program could not complete an operation succesfully. Action______ActionActionAction messages indicate that some action is required from you. Either a response must be typed or a device requires attention. RECOVERING__________RECOVERINGRECOVERINGRECOVERING_FROM____FROMFROMFROM_ERRORS______ERRORSERRORSERRORS Note that some errors are recoverable. In this case, PC-ZAP will prompt you with the following message after the error message has been displayed: Appendix A. ERROR MESSAGES 20 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide +-----------------------------------------------------------------+ | | | Abort,Abort,Abort,Abort, Retry,Retry,Retry,Retry, Ignore?_Ignore?_Ignore?_Ignore?_ | | | | | | Figure 7. Recovery prompt | +-----------------------------------------------------------------+ You may type the letter "A", "R" or "I" (lowercase is fine) to indicate respectively that: o PC-ZAP should abort and terminate immediately (A) o PC-ZAP should retry the operation that caused the error (R) o PC-ZAP should ignore the operation that caused the error and continue (I) Ignoring an operation is hazardous as PC-ZAP will con- tinue as if the operation causing the error completed normally. Retrying is always safe unless the condition causing the error is not corrected, in which case you will get the same error message and prompt again. Abort is normally used when you cannot correct the error (such as trying to print on a non-existent prin- ter.) Appendix A. ERROR MESSAGES 21 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide EXPLANATION___________EXPLANATIONEXPLANATIONEXPLANATION_OF__OFOFOF_ERROR_____ERRORERRORERROR_MESSAGES________MESSAGESMESSAGESMESSAGES ZAP000IZAP000IZAP000IZAP000I PC-ZAPPC-ZAPPC-ZAPPC-ZAP ENDEDENDEDENDEDENDED ---- RETURNRETURNRETURNRETURN CODECODECODECODE xxxxxxxx Explanation___________: This is an informational mes- sage which PC-ZAP issues at the end of each run. The return code indicates the severity of the highest error encountered. +-----------------------------------------------------------------+ | | | RETURNRETURNRETURNRETURN | | CODECODECODECODE | | 0000 SuccesfullSuccesfullSuccesfullSuccesfull completion.completion.completion.completion. NoNoNoNo errors.errors.errors.errors. | | 8888 AAAA VERVERVERVER statementstatementstatementstatement failed.failed.failed.failed. TheTheTheThe NOGONOGONOGONOGO switchswitchswitchswitch waswaswaswas set.set.set.set. | | 12121212 OneOneOneOne orororor moremoremoremore commandscommandscommandscommands interruptedinterruptedinterruptedinterrupted (Ctrl-Break(Ctrl-Break(Ctrl-Break(Ctrl-Break key).key).key).key). | | 16161616 SevereSevereSevereSevere error.error.error.error. | | | | | | Figure 8. PC-ZAP Return Codes | +-----------------------------------------------------------------+ System_______Action______:PC-ZAP terminates after dis- play of this message. User_____Response________: None ZAP024EZAP024EZAP024EZAP024E DEVICEDEVICEDEVICEDEVICE TIMEOUTTIMEOUTTIMEOUTTIMEOUT Explanation___________: Your printer did not respond during a print request. System_______Action______: PC-ZAP will prompt you to "Abort, Retry or Ignore ?" User______Response________: Check the printer, then respond "R" to the "Abort, Retry, or Ignore?" prompt displayed following this message; or respond "A" to abort this run and reissue the PC-ZAP command. If you do not wish printer output, route it to the screen. See "PC-ZAP Command" on page 6 for details. ZAP025EZAP025EZAP025EZAP025E DEVICEDEVICEDEVICEDEVICE FAULTFAULTFAULTFAULT Explanation___________: A device (most likely your printer) indicated it had a problem (such as a paper jam). Appendix A. ERROR MESSAGES 22 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide System_______Action______: PC-ZAP will prompt you to "Abort, Retry or Ignore ?" User______Response________: Check the printer, then respond "R" to the "Abort, Retry, or Ignore?" prompt displayed following this message; or respond "A" to abort this run and reissue the PC-ZAP command. If you do not wish printer output, route it to the screen. See "PC-ZAP Command" on page 6 for details. ZAP027EZAP027EZAP027EZAP027E OUTOUTOUTOUT OFOFOFOF PAPERPAPERPAPERPAPER Explanation___________: Self-explanatory. System_______Action______: PC-ZAP will prompt you to "Abort, Retry or Ignore ?" User______Response________: Check the printer, then respond "R" to the "Abort, Retry, or Ignore?" prompt displayed following this message; or respond "A" to abort this run and reissue the PC-ZAP command. If you do not wish printer output, route it to the screen. See "PC-ZAP Command" on page 6 for details. ZAP052EZAP052EZAP052EZAP052E BADBADBADBAD FILEFILEFILEFILE NUMBER:NUMBER:NUMBER:NUMBER: filenamefilenamefilenamefilename Explanation___________: The file name you specified on the PC-ZAP command or on the NAME or DUMP command is invalid (contains a comma, for example). System_______Action______: The command is ignored and the NOGO switch is set. User_____Response________: Check the spelling of the file name as displayed in this message and reissue the command with the correct name. ZAP053EZAP053EZAP053EZAP053E FILEFILEFILEFILE NOTNOTNOTNOT FOUND:FOUND:FOUND:FOUND: filenamefilenamefilenamefilename Explanation___________: The file you specified on the PC-ZAP command or on the NAME or DUMP com- mand was not found on the specified drive Appendix A. ERROR MESSAGES 23 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide (or default drive if no drive was specified in the file name. Note that under DOS 2.0 only the current directory for each drive is accessible (this is a BASIC compiler restriction). System_______Action______: The command is ignored and the NOGO switch is set. User_____Response________: Verify the spelling of the file name and check that the file exists; then reissue the command with the correct file name. ZAP057EZAP057EZAP057EZAP057E DEVICEDEVICEDEVICEDEVICE I/OI/OI/OI/O ERRORERRORERRORERROR Explanation___________: A device (most likely your printer) has a problem (it was powered off in the middle of printing, for example). System_______Action______: PC-ZAP will prompt you to "Abort, Retry or Ignore ?" User______Response________: Check the printer, then respond "R" to the "Abort, Retry, or Ignore?" prompt displayed following this message; or respond "A" to abort this run and reissue the PC-ZAP command. If you do not wish printer output, route it to the screen. See "PC-ZAP Command" on page 6 for details. ZAP058EZAP058EZAP058EZAP058E FILEFILEFILEFILE ALREADYALREADYALREADYALREADY EXISTS:EXISTS:EXISTS:EXISTS: filefilefilefile namenamenamename Explanation___________: This message should not occur. System_______Action______: The command is ignored and the NOGO switch is set. User_____Response________: Contact Pelt Industries. ZAP061EZAP061EZAP061EZAP061E DISKDISKDISKDISK FULLFULLFULLFULL Explanation___________: PC-ZAP could not write another line to the run listing file because the disk on which it resides has no more free space. Appendix A. ERROR MESSAGES 24 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide System_______Action______: PC-ZAP will prompt you to "Abort, Retry or Ignore ?" User_____Response________: Reply "A" to abort the cur- rent run and either delete files from the full disk is route the run listing to anoth- er drive or disk. ZAP064EZAP064EZAP064EZAP064E BADBADBADBAD FILEFILEFILEFILE NAME:NAME:NAME:NAME: filefilefilefile namenamenamename Explanation___________: The file name you specified on the PC-ZAP command or on the NAME or DUMP command is invalid (contains a comma, for example). System_______Action______: The command is aborted and the NOGO switch is set. User_____Response________: Check the spelling of the file name as displayed in this message and reissue the command with the correct name. ZAP068EZAP068EZAP068EZAP068E DEVICEDEVICEDEVICEDEVICE UNAVAILABLEUNAVAILABLEUNAVAILABLEUNAVAILABLE Explanation___________: You attempted to use a device which does not exist on yoyr system (such as LPT1: when you have no printer, or drive C: when you have no C drive) System_______Action______: PC-ZAP ignores the command and sets the NOGO switch. User_____Response________: Check the spelling of the command which caused this error. If you are sure that the specified device exists on your system, reboot your system and retry the command. ZAP070EZAP070EZAP070EZAP070E DISKDISKDISKDISK WRITEWRITEWRITEWRITE PROTECTEDPROTECTEDPROTECTEDPROTECTED Explanation___________: You attempted to write onto a disk which is write-protected (the read/write notch on the diskette is cov- ered.) System_______Action______: PC-ZAP will prompt you to "Abort, Retry, or Ignore?" Appendix A. ERROR MESSAGES 25 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide User_____Response________: If you do not___notnotnot want to write onto the diskette, reply "A" to abort the run. If you do__dododo wish to write onto the disk- ette, remove it from the drive, peel off the write-protect tab; then put the same____samesamesame disk- kette back into the drive. Then reply "R" to the prompt, to retry the operation. Do NOT___NOTNOTNOT replace the diskette with another one as this is sure to clobber the information on it. ZAP071EZAP071EZAP071EZAP071E DISKDISKDISKDISK NOTNOTNOTNOT READYREADYREADYREADY Explanation___________: An attempt to read or write from a disk drive failed because the drive is not ready (most likely caused by the drive door being open or no diskette in the drive). System_______Action______: PC-ZAP will prompt you to "Abort, Retry, or Ignore?" User_____Response________: Make sure that the drive has a diskette in it and that the drive door is closed. Reply "R" to retry the operation or "A" to abort the run. ZAP072EZAP072EZAP072EZAP072E DISKDISKDISKDISK MEDIAMEDIAMEDIAMEDIA ERRORERRORERRORERROR Explanation___________: An attempt to read or write from a disk failed due to a problem with the diskette (may be worn out). System_______Action______: PC-ZAP will prompt you to "Abort, Retry, or Ignore?" User_____Response________: Remove the diskkete from the drive and check that it is not warped or damaged. Reseat the diskette into the drive and reply "R" to retry the operation. If repeated retries fail to eliminate the prob- lem, reply "A" to abort the run. Copy the diskette to another one and retry the entire PC-ZAP run. Appendix A. ERROR MESSAGES 26 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide ZAP076EZAP076EZAP076EZAP076E PATHPATHPATHPATH NOTNOTNOTNOT FOUND:FOUND:FOUND:FOUND: pathnamepathnamepathnamepathname Explanation___________: Should not occur. System_______Action______: PC-ZAP terminates after dis- play of this message. User_____Response________: Contact Pelt Industries. ZAP091EZAP091EZAP091EZAP091E NOGONOGONOGONOGO SWITCHSWITCHSWITCHSWITCH ISISISIS SETSETSETSET Explanation___________: A REP command was rejected because a previous VER command failed (see message ZAP093E). The NOGO switch is reset by the next DUMP or NAME command. This mes- sage indicates that the REP command was not processed. System_______Action______: PC-ZAP ignores the REP com- mand. User______Response________: Check for error messages prior to this one to find the cause of the NOGO switch being set. ZAP092IZAP092IZAP092IZAP092I OLDOLDOLDOLD DATADATADATADATA WASWASWASWAS xxxxxxxx Explanation___________: A REP command was successfully processed, the old data at the specified changed locations is displayed in this mes- sage. System________Action______: PC-ZAP continues with the next command. User_____Response________: None ZAP093EZAP093EZAP093EZAP093E VERIFICATIONVERIFICATIONVERIFICATIONVERIFICATION FAILEDFAILEDFAILEDFAILED Explanation___________: A VER command failed because the file to be zapped does not contain the specified data at the specified offset. System_______Action______: The NOGO switch is set and all subsequent REP commands (upto the next DUMP or NAME command) are rejected with error message ZAP091E (see above). Appendix A. ERROR MESSAGES 27 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide User______Response________: This error indicates that the zap you are trying to apply is not cor- rect. Use the DUMP command to check the actual contents of the file to be zapped and change the VER command which failed. ZAP094EZAP094EZAP094EZAP094E ODDODDODDODD NUMBERNUMBERNUMBERNUMBER OFOFOFOF HEXHEXHEXHEX DIGITSDIGITSDIGITSDIGITS ININININ DATADATADATADATA Explanation___________: The data operand of a VER or REP command did not contain an even number of hexadecimal digits. System_______Action______: PC-ZAP ignores the command. The NOGO switch is set. User_____Response________: Check the command for typing errors; add a leading zero if necessary to ensure an even number of digits. Reissue the last NAME command (to reset the NOGO switch) and the correct VER or REP command. ZAP095EZAP095EZAP095EZAP095E INVALIDINVALIDINVALIDINVALID OROROROR MISSINGMISSINGMISSINGMISSING HEXHEXHEXHEX DATADATADATADATA Explanation___________: The data operand of a VER or REP command was not specified or contained characters other than hexadecimal digits (0 through 9 or A through F). System_______Action______: PC-ZAP ignores the command. The NOGO switch is set. User_____Response________: Check the command for typing errors; add a leading zero if necessary to ensure an even number of digits. Reissue the last NAME command (to reset the NOGO switch) and the correct VER or REP command. ZAP096EZAP096EZAP096EZAP096E OFFSETOFFSETOFFSETOFFSET TOOTOOTOOTOO LARGELARGELARGELARGE ---- FILEFILEFILEFILE SIZESIZESIZESIZE ISISISIS ONLYONLYONLYONLY xxxxxxxxxxxxxxxxxxxx Explanation___________: The offset operand of a BASE, VER or REP command was too large for the size of the file being zapped. This normally indicates the zap you are trying to apply is incorrect. Keep in mind that for VER and REP commands the actual offset used is the sum of any base value (if specified by a previ- ous BASE command) and the offset specified on the VER or REP command. Appendix A. ERROR MESSAGES 28 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide System_______Action______: PC-ZAP ignores the command. The NOGO switch is set. User_____Response________: Check the command for typing errors; Reissue the last NAME command (to reset the NOGO switch) and the correct BASE, VER or REP command. ZAP097EZAP097EZAP097EZAP097E INVALIDINVALIDINVALIDINVALID OROROROR MISSINGMISSINGMISSINGMISSING OFFSETOFFSETOFFSETOFFSET VALUEVALUEVALUEVALUE Explanation___________: The offset operand of a BASE, VER or REP command was not specified or con- tained characters other than hexadecimal digits (0 through 9 or A through F). System_______Action______: PC-ZAP ignores the command. The NOGO switch is set. User_____Response________: Check the command for typing errors; then reissue the last NAME command (to reset the NOGO switch) and the correct BASE, VER or REP command. ZAP098IZAP098IZAP098IZAP098I COMMANDCOMMANDCOMMANDCOMMAND INTERRUPTEDINTERRUPTEDINTERRUPTEDINTERRUPTED BYBYBYBY BREAKBREAKBREAKBREAK KEYKEYKEYKEY Explanation___________: You pressed the Ctrl-Break key during the execution of a command. In batch mode. System_______Action______: In batch mode, PC-ZAP will terminate and not process any remaining com- mands in the zap file. In interactive mode, the user is returned to the "ZAP>" prompt. User_____Response________: In interactive mode, You may enter the "END" command in the to terminate PC-ZAP. ZAP099IZAP099IZAP099IZAP099I COMMANDCOMMANDCOMMANDCOMMAND ABORTEDABORTEDABORTEDABORTED Explanation___________: A command was not completed due to an error. This message is informa- tional only. A preceeding error message indicates the cause of the error. System_______Action______: The command is ignored. If the error was severe, PC-ZAP will terminate. Appendix A. ERROR MESSAGES 29 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide User_____Response________: Check previous messages for the reason why the command was aborted. ZAP100EZAP100EZAP100EZAP100E INVALIDINVALIDINVALIDINVALID COMMANDCOMMANDCOMMANDCOMMAND OROROROR COMMANDCOMMANDCOMMANDCOMMAND OUTOUTOUTOUT OFOFOFOF SEQUENCESEQUENCESEQUENCESEQUENCE Explanation___________: You entered an unrecognizable command (not BASE, VER, REP, NAME, DUMP or END) or a command was issued out of sequence (for example a VER or REP command without a preceeding NAME command.) Note that VER, REP and BASE commands must either be preceeded by a NAME command, or you must have speci- fied a file name to be zapped on the PC-ZAP command (second operand). System_______Action______: PC-ZAP ignores the command. The NOGO switch is set. User_____Response________: Check "Chapter 3. Reference" on page 12 for details. Appendix A. ERROR MESSAGES 30 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide APPENDIX________APPENDIXAPPENDIXAPPENDIX_B.__B.B.B._SAMPLE______SAMPLESAMPLESAMPLE_ZAP___ZAPZAPZAP_FILES_____FILESFILESFILES DISCLAIMER__________DISCLAIMERDISCLAIMERDISCLAIMER The zaps listed in this appendix are examples only of the type of changes that can be made to existing soft- ware packages to increase their usefulness and enhance their performance. Some of the zaps will change a program to bypass checks for copy protection. The inclusion of such zaps is in no way meant to encourage or condone the practice of software piracy. Legiti- mate owners of software packages however have a great need (and right) to be able to copy legally obtained software to other media such as hard disks and backup floppies, subject to any U.S. or foreign copyright laws or licensing agreement the user has or should have with the owner of copyright. Appendix B. SAMPLE ZAP FILES 31 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide 123.ZAP_______123.ZAP123.ZAP123.ZAP_-_---_UNPROTECT_________UNPROTECTUNPROTECTUNPROTECT_LOTUS_____LOTUSLOTUSLOTUS_123___123123123 The file 123.ZAP contains a ZAP to modify Lotus 123 to bypass checking for copy protection. After applying this ZAP, the module 123.EXE will run from any disk type even after being copied (with the DOS COPY com- mand for example.) ************************************************************************ * October 1983 * * FILE NAME - 123.ZAP * * * * FUNCTION - CHANGE LOTUS 123.EXE TO BYPASS COPY PROTECTION CHECK * * * * INSTRUCTIONS - * * * * 1. COPY 123.EXE TO A NEW DISK * * * * 2. PUT ON THIS ZAP BY ISSUING COMMAND: * * * * PC-ZAP 123.ZAP 123.EXE; * * * * WHERE 123.EXE IS THE NAME OF THE FILE TO BE ZAPPED * * AND 123.ZAP IS THE NAME OF THE FILE YOU ARE READING * * * * 3. THE ZAPPED 123.EXE CAN BE COPIED AT WILL HENCEFORTH * * * * AUTHOR - MARK PELT * * * * NOTES - THE PC-ZAP PROGRAM CAN BE OBTAINED BY SENDING A BLANK * * FLOPPY DISK OR $20 TO THE FOLLOWING ADDRESS. SPECIFY * * DOS VERSION, AND DISKETTE FORMAT (8 OR 9 SECTOR, * * SINGLE OR DOUBLE SIDED). * * * * PELT INDUSTRIES * * 121 BUCKINGHAM DRIVE, #55 * * SANTA CLARA, CA 95050 * * * * * * (C) COPYRIGHT 1983 PELT INDUSTRIES. ALL RIGHTS RESERVED. * * * ************************************************************************ BASE 100 SKIP .EXE HEADER VER A9A9 CD13 INT 13 CALL TO BIOS DISKETTE_I/O ROUTINE REP A9A9 9090 NOP,NOP Applying________ApplyingApplyingApplying_the___thethethe_ZAP___ZAPZAPZAP To apply this ZAP, simply issue the following PC-ZAP command from DOS. Appendix B. SAMPLE ZAP FILES 32 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide +-----------------------------------------------------------------+ | | | PC-ZAP A:123.ZAP B:123.EXE; | | | +-----------------------------------------------------------------+ In the above example, the file 123.EXE on drive B will be modified. This is the Lotus 123 spreadsheet pro- gram. The ZAP commands are contained in file 123.ZAP on drive A. Since the command is followed by a semico- lon, no prompting for the third operand (not speci- fied) will be made. The output from the run will by default be displayed on the screen. Appendix B. SAMPLE ZAP FILES 33 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide EW.ZAP______EW.ZAPEW.ZAPEW.ZAP_-_---_UNPROTECT_________UNPROTECTUNPROTECTUNPROTECT_EASYWRITER__________EASYWRITEREASYWRITEREASYWRITER The file EW.ZAP contains a ZAP to modify Easywriter to bypass checking for copy protection. After applying this ZAP, the module IBM88VMI.COM will run from any disk type even after being copied (with the DOS COPY command for example.) ************************************************************************ * November 1983 * * FILE NAME - EW.ZAP * * * * FUNCTION - CHANGE EASY/WRITER VERSION 1.1 TO BYPASSS COPY * * PROTECTION CHECKING * * * * INSTRUCTIONS - * * * * 1. COPY FILE IBM88VMI.COM TO A NEW DISK * * * * 2. PUT ON THIS ZAP BY ISSUING COMMAND: * * * * PC-ZAP EW.ZAP IBM88VMI.COM; * * * * WHERE IBM88VMI.COM IS THE NAME OF THE FILE TO BE * * ZAPPED AND EW.ZAP IS THE NAME OF THE FILE YOU ARE * * CURRENTLY READING * * * * 3. THE ZAPPED EASY/WRITER MAY BE COPIED AT WILL * * * * AUTHOR - MARK PELT * * * * NOTES - THE PC-ZAP PROGRAM CAN BE OBTAINED BY SENDING A BLANK * * FLOPPY DISK OR $20 TO THE FOLLOWING ADDRESS. SPECIFY * * DOS VERSION, AND DISKETTE FORMAT (8 OR 9 SECTOR, * * SINGLE OR DOUBLE SIDED). * * * * PELT INDUSTRIES * * 121 BUCKINGHAM DRIVE, #55 * * SANTA CLARA, CA 95050 * * * * * * (C) COPYRIGHT 1983 PELT INDUSTRIES. ALL RIGHTS RESERVED. * * * ************************************************************************ VER 0185 CD20 INT 20 CALL TO DOS REP 0185 9090 NOP,NOP Applying________ApplyingApplyingApplying_the___thethethe_ZAP___ZAPZAPZAP To apply this ZAP, simply issue the following PC-ZAP command from DOS. Appendix B. SAMPLE ZAP FILES 34 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide +-----------------------------------------------------------------+ | | | PC-ZAP EW.ZAP IBM88VMI.COM; | | | +-----------------------------------------------------------------+ In the above example, the file IBM88VMI.COM on the default drive will be modified. This is the module invoked by the EasyWriter program during initializa- tion. The ZAP commands are contained in file EW.ZAP on the default drive. Since the third operand is omitted, the output from the run will be displayed on the screen. Appendix B. SAMPLE ZAP FILES 35 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide FORMATV.ZAP___________FORMATV.ZAPFORMATV.ZAPFORMATV.ZAP_-_---_MAKE____MAKEMAKEMAKE_/V__/V/V/V_DEFAULT_______DEFAULTDEFAULTDEFAULT_FOR___FORFORFOR_FORMAT.COM__________FORMAT.COMFORMAT.COMFORMAT.COM The file FORMATV.ZAP contains a ZAP to modify the DOS FORMAT command to always prompt for a volume label. After applying this ZAP, the module FORMAT.COM will no longer require that you enter the /V operand. ************************************************************************ * January 1984 * * FILE NAME - FORMATV.ZAP * * * * FUNCTION - CHANGE DOS 2.0 FORMAT COMMAND TO USE /V AS DEFAULT. * * THE /V OPTION WILL PROMPT FOR A VOLUME LABEL. * * * * INSTRUCTIONS - * * * * 1. COPY FORMAT.COM TO A NEW DISK * * * * 2. PUT ON THIS ZAP BY ISSUING COMMAND: * * * * PC-ZAP FORMATV.ZAP FORMAT.COM; * * * * WHERE FORMAT.COM IS THE NAME OF THE FILE TO BE * * ZAPPED AND FORMATV.ZAP IS THE NAME OF THE FILE YOU * * ARE NOW READING * * * * 3. THE ZAPPED FORMAT.COM WILL NOW ALWAYS PROMPT FOR A * * VOLUME LABEL. * * * * AUTHOR - MARK PELT * * * * NOTES - THE PC-ZAP PROGRAM CAN BE OBTAINED BY SENDING A BLANK * * FLOPPY DISK OR $20 TO THE FOLLOWING ADDRESS. SPECIFY * * DOS VERSION, AND DISKETTE FORMAT (8 OR 9 SECTOR, * * SINGLE OR DOUBLE SIDED). * * * * PELT INDUSTRIES * * 121 BUCKINGHAM DRIVE, SUITE 55 * * SANTA CLARA, CA 95050 * * * * * * (C) COPYRIGHT 1984 MARKUS PELT. ALL RIGHTS RESERVED. * * * ************************************************************************ VER 07C7 74F0 JZ 7B9 SKIP LABEL PROCESSING REP 07C7 75F0 JNZ 7B9 DON'T SKIP Applying________ApplyingApplyingApplying_the___thethethe_ZAP___ZAPZAPZAP To apply this ZAP, simply issue the following PC-ZAP command from DOS. Appendix B. SAMPLE ZAP FILES 36 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide +-----------------------------------------------------------------+ | | | PC-ZAP A:FORMATV.ZAP B:FORMAT.COM; | | | +-----------------------------------------------------------------+ In the above example, the file FORMAT.COM on drive B will be modified. This is the DOS command which for- mats floopy disks. The ZAP commands are contained in file FORMATV.ZAP on drive A. Since the third operand is omitted, the output from the run will be displayed on the screen. Appendix B. SAMPLE ZAP FILES 37 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide GEMGRAPH.ZAP____________GEMGRAPH.ZAPGEMGRAPH.ZAPGEMGRAPH.ZAP_-_---_GRAPHICS.COM____________GRAPHICS.COMGRAPHICS.COMGRAPHICS.COM_FOR___FORFORFOR_GEMINI______GEMINIGEMINIGEMINI_PRINTERS________PRINTERSPRINTERSPRINTERS The file GEMGRAPH.ZAP contains a ZAP to modify the DOS GRAPHICS command to support the Star Gemini printer series. After applying this ZAP, the module GRAPH- ICS.COM will will be able to dump screen graphics cor- rectly to a Star Gemini printer. ************************************************************************ * October 1983 * * FILE NAME - GEMGRAPH.ZAP * * * * FUNCTION - CHANGE DOS GRAPHICS.COM COMMAND FOR STAR MICRONICS * * GEMINI 15 PRINTER * * * * INSTRUCTIONS - * * * * 1. COPY GRAPHICS.COM TO A NEW DISK * * * * 2. PUT ON THIS ZAP BY ISSUING COMMAND: * * * * PC-ZAP GEMGRAPH.ZAP GRAPHICS.COM; * * * * WHERE GRAPHICS.COM IS THE NAME OF THE FILE TO BE * * ZAPPED AND GEMGRAPH.ZAP IS THE NAME OF TEH FILE YOU * * ARE READING. * * * * 3. THE ZAPPED GRAPHICS.COM CAN BE COPIED WITHOUT * * RE-APPLICATION OF THIS ZAP AFTER EACH COPY. * * * * AUTHOR - MARK PELT * * * * NOTES - THE PC-ZAP PROGRAM CAN BE OBTAINED BY SENDING A BLANK * * FLOPPY DISK OR $20 TO THE FOLLOWING ADDRESS. SPECIFY * * DOS VERSION, AND DISKETTE FORMAT (8 OR 9 SECTOR, * * SINGLE OR DOUBLE SIDED). * * * * PELT INDUSTRIES * * 121 BUCKINGHAM DRIVE, #55 * * SANTA CLARA, CA 95050 * * * * * * (C) COPYRIGHT 1983 PELT INDUSTRIES. ALL RIGHTS RESERVED. * * * ************************************************************************ BASE 100 SKIP .COM HEADER VER 69 18 LINE FEED LENGTH OF 24/144TH INCH REP 69 08 SET LINE FEED LENGTH TO 8/144TH INCH Applying________ApplyingApplyingApplying_the___thethethe_ZAP___ZAPZAPZAP Appendix B. SAMPLE ZAP FILES 38 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide To apply this ZAP, simply issue the following PC-ZAP command from DOS. +-----------------------------------------------------------------+ | | | PC-ZAP A:GEMGRAPH.ZAP B:GRAPHICS.COM; | | | +-----------------------------------------------------------------+ In the above example, the file GRAPHICS.COM on drive B will be modified. This is the DOS command which allows the Shift-PrtSC key combination to print a graphics picture from the screen to yoyr printer. The ZAP commands are contained in file GEMGRAPH.ZAP on drive A. Since the third operand is omitted, the out- put from the run will be displayed on the screen. Appendix B. SAMPLE ZAP FILES 39 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide MS.ZAP______MS.ZAPMS.ZAPMS.ZAP_-_---_UNPROTECT_________UNPROTECTUNPROTECTUNPROTECT_MEMORYSHIFT___________MEMORYSHIFTMEMORYSHIFTMEMORYSHIFT The file MS.ZAP contains a ZAP to modify MemoryShift to bypass checking for copy protection. After applying this ZAP, the module MS.EXE will run from any disk type even after being copied (with the DOS COPY com- mand for example.) ************************************************************************ * October 1983 * * FILE NAME - MS.ZAP * * * * FUNCTION - CHANGE MEMORY-SHIFT MS.EXE TO BYPASS COPY PROTECTION * * CHECKING * * * * INSTRUCTIONS - * * * * 1. COPY MS.EXE TO A NEW DISK * * * * 2. PUT ON THIS ZAP BY ISSUING COMMAND: * * * * PC-ZAP MS.ZAP MS.EXE; * * * * WHERE MS.EXE IS THE NAME OF THE FILE TO BE ZAPPED * * AND MS.ZAP IS THE NAME OF THE FILE YOU ARE READING * * * * 3. THE ZAPPED MS.EXE CAN BE COPIED AT WILL HENCEFORTH * * * * AUTHOR - MARK PELT * * * * NOTES - THE PC-ZAP PROGRAM CAN BE OBTAINED BY SENDING A BLANK * * FLOPPY DISK OR $20 TO THE FOLLOWING ADDRESS. SPECIFY * * DOS VERSION, AND DISKETTE FORMAT (8 OR 9 SECTOR, * * SINGLE OR DOUBLE SIDED). * * * * PELT INDUSTRIES * * 121 BUCKINGHAM DRIVE, #55 * * SANTA CLARA, CA 95050 * * * * * * (C) COPYRIGHT 1983 PELT INDUSTRIES. ALL RIGHTS RESERVED. * * * ************************************************************************ BASE 100 * SKIP .EXE HEADER VER 1FDC CD * INT CALL TO BIOS DISKETTE_I/O ROUTINE VER 1FE4 13 * 13H CALL TO BIOS DISKETTE_I/O ROUTINE VER 1569 75E1 * JNZ 154C JUMP IF ERROR REP 1FDC 90 * NOP NOP INT INSTRUCTION REP 1FE4 90 * NOP NOP 13H OPERAND REP 1569 EB1B * JMP 1586 JUMP OVER ALL CHECKING Appendix B. SAMPLE ZAP FILES 40 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide Applying________ApplyingApplyingApplying_the___thethethe_ZAP___ZAPZAPZAP To apply this ZAP, simply issue the following PC-ZAP command from DOS. +-----------------------------------------------------------------+ | | | PC-ZAP A:MS.ZAP B:MS.EXE LPT1: | | | +-----------------------------------------------------------------+ In the above example, the file MS.EXE on drive B will be modified. This is the main MemoryShift program. The ZAP commands are contained in file MS.ZAP on drive A. Since the third operand is LPT1:, the output from the run will be printed on the first (or only) printer instead of being displayed on the screen. Appendix B. SAMPLE ZAP FILES 41 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide PECOLOR.ZAP___________PECOLOR.ZAPPECOLOR.ZAPPECOLOR.ZAP_-_---_IBM___IBMIBMIBM_PERSONAL________PERSONALPERSONALPERSONAL_EDITOR______EDITOREDITOREDITOR_COLOR_____COLORCOLORCOLOR_SUPPORT_______SUPPORTSUPPORTSUPPORT The file PECOLOR.ZAP contains a ZAP to modify the IBM Personal Editor program PE.EXE to display various parts of the screen in color. The different areas that can have separate background and foreground col- ors are the text area, the command line area (line 23), the status line area (line 24) and the error mes- sage area (line 25), as well as the color attribute for the cursor when it is moved from a normal text area to the command line area, or from a marked text area to the command line. After applying this ZAP, the module PE.EXE will be use the indicated colors whenever used on a color display. Appendix B. SAMPLE ZAP FILES 42 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide ************************************************************************ * January 1984 * * FILE NAME - PECOLOR.ZAP * * * * FUNCTION - CHANGE IBM PERSONAL EDITOR TO DISPLAY SCREEN IN VARIOUS* * COLORS. * * * * INSTRUCTIONS - * * * * 1. COPY PE.EXE TO A NEW DISK * * * * 2. PUT ON THIS ZAP BY ISSUING COMMAND: * * * * PC-ZAP PECOLOR.ZAP PE.EXE; * * * * WHERE PE.EXE IS THE NAME OF THE FILE TO BE ZAPPED * * AND PECOLOR.ZAP IS THE NAME OF THE FILE YOU ARE * * READING. * * * * 3. THE CHANGED PE.EXE WILL USE THE VARIOUS PARTS OF * * THE SCREEN IN THE COLORS SELECTED BELOW. * * * * AUTHOR - MARK PELT * * * * NOTES - THE PC-ZAP PROGRAM CAN BE OBTAINED BY SENDING A BLANK * * FLOPPY DISK OR $20 TO THE FOLLOWING ADDRESS. SPECIFY * * DOS VERSION, AND DISKETTE FORMAT (8 OR 9 SECTOR, * * SINGLE OR DOUBLE SIDED). * * * * PELT INDUSTRIES * * 121 BUCKINGHAM DRIVE, #55 * * SANTA CLARA, CA 95050 * * * * * * (C) COPYRIGHT 1983 MARKUS PELT. ALL RIGHTS RESERVED. * * * ************************************************************************ VER A160 07 NORMAL TEXT (BLACK BACKGROUND, GREY FOREGROUND) VER A161 70 MARKED TEXT (BLACK ON GREY) VER A162 17 NORMAL CURSOR (GREY ON BLUE) VER A163 71 MARKED CURSOR (BLUE ON GREY) VER A164 71 CMD LINE (BLUE ON GREY) VER A165 07 STATUS LINE (GREY ON BLACK) VER A166 04 ERROR MSG LINE (RED ON BLACK) REP A160 0F NORMAL TEXT (BLACK BACKGROUND,WHITE FOREGROUND) REP A161 1F MARKED TEXT (WHITE ON BLUE) REP A162 E8 NORMAL CURSOR (BLINKING BLACK ON LIGHT YELLOW) REP A163 E9 MARKED CURSOR (BLINKING BLUE ON LIGHT YELLOW) REP A164 21 CMD LINE (BLUE ON GREEN) REP A165 68 STATUS LINE (BLACK ON LIGHT YELLOW) REP A166 48 ERROR MSG LINE (BLACK ON LIGHT RED) Applying________ApplyingApplyingApplying_the___thethethe_ZAP___ZAPZAPZAP Appendix B. SAMPLE ZAP FILES 43 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide To apply this ZAP, simply issue the following PC-ZAP command from DOS. +-----------------------------------------------------------------+ | | | PC-ZAP A:PECOLOR.ZAP B:PE.EXE; | | | +-----------------------------------------------------------------+ In the above example, the file PE.EXE on drive B will be modified. The ZAP commands are contained in file PECOLOR.ZAP on drive A. Since the third operand is omitted, the output from the run will be displayed on the screen. Appendix B. SAMPLE ZAP FILES 44 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide PELOGO.ZAP__________PELOGO.ZAPPELOGO.ZAPPELOGO.ZAP_-_---_BYPASS______BYPASSBYPASSBYPASS_IBM___IBMIBMIBM_PERSONAL________PERSONALPERSONALPERSONAL_EDITOR______EDITOREDITOREDITOR_LOGO____LOGOLOGOLOGO The file PELOGO.ZAP contains a ZAP to modify the IBM Personal Editor program PE.EXE so that the initial display of the IBM logo is skipped. After applying this ZAP, the user will no longer be prompted to press any key to continue initilization. ************************************************************************ * January 1984 * * FILE NAME - PELOGO.ZAP * * * * FUNCTION - CHANGE IBM PERSONAL EDITOR TO BYPASS INITIAL DISPLAY * * OF IBM LOGO. * * * * INSTRUCTIONS - * * * * 1. COPY PE.EXE TO A NEW DISK * * * * 2. PUT ON THIS ZAP BY ISSUING COMMAND: * * * * PC-ZAP PELOGO.ZAP PE.EXE; * * * * WHERE PE.EXE IS THE NAME OF THE FILE TO BE ZAPPED * * AND PELOGO.ZAP IS THE NAME OF THE FILE YOU ARE * * READING. * * * * 3. THE ZAPPED PE.EXE WILL NOT DISPLAY THE INITIAL IBM * * LOGO NOR WAIT FOR A KEY PRESS TO CONTINUE. * * * * AUTHOR - MARK PELT * * * * NOTES - THE PC-ZAP PROGRAM CAN BE OBTAINED BY SENDING A BLANK * * FLOPPY DISK OR $20 TO THE FOLLOWING ADDRESS. SPECIFY * * DOS VERSION, AND DISKETTE FORMAT (8 OR 9 SECTOR, * * SINGLE OR DOUBLE SIDED). * * * * PELT INDUSTRIES * * 121 BUCKINGHAM DRIVE, #55 * * SANTA CLARA, CA 95050 * * * * * * (C) COPYRIGHT 1983 MARKUS PELT. ALL RIGHTS RESERVED. * * * ************************************************************************ VER 0C95 FF3604F4 PUSH [F404] REP 0C95 EB61 JMP DF8 REP 0C97 9090 NOP,NOP Applying________ApplyingApplyingApplying_the___thethethe_ZAP___ZAPZAPZAP Appendix B. SAMPLE ZAP FILES 45 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide To apply this ZAP, simply issue the following PC-ZAP command from DOS. +-----------------------------------------------------------------+ | | | PC-ZAP A:PELOGO.ZAP B:PE.EXE; | | | +-----------------------------------------------------------------+ In the above example, the file PE.EXE on drive B will be modified. The ZAP commands are contained in file PELOGO.ZAP on drive A. Since the third operand is omitted, the output from the run will be displayed on the screen. Appendix B. SAMPLE ZAP FILES 46 PC-ZAPPC-ZAPPC-ZAPPC-ZAP User'sUser'sUser'sUser's GuideGuideGuideGuide GLOSSARY________GLOSSARYGLOSSARYGLOSSARY apply:apply:apply:apply: to apply a zap file:file:file:file: Under DOS, a collection of data referred to by a file command:command:command:command: A name for an instruc- name. tion to the computer. The PC-ZAP REP command, for example, filefilefilefile name:name:name:name: Under DOS, a name to instructs the computer to refer to a file. A file name may replace data. consist of an 8 character name and an optional period with a device:device:device:device: a piece of equipment. A three character extension. The printer, a disk drive, a modem extension part is used to iden- adapter card are all devices. tify the type of data contained Under DOS each device is in the file. For example, ".BAS" assigned a unique device name. is a common extension for BASIC source program files, while devicedevicedevicedevice name:name:name:name: Under DOS, each ".COM" is a common extension for device is assigned a unique DOS command program files, such device name. The disk drives as SAMPLES.BAS and DISKCOPY.COM. are identified by a single let- ter and a semicolon (A:, B:, C:, offset:offset:offset:offset: A number which identi- printers by the word "LPT" fol- fies the location of a byte in a lowed by a digit and a semicolon file relative to the start of (LPT1:, LPT2:); modems by the the file. The first byte of a word "COM" followed by a digit file is located at offset zero. and a semicolon (COM1:, COM2:, COM3:, COM4:). In addition, DOS program:program:program:program: A DOS file ending with uses the generic names "CON:", the extension ".EXE" or ".COM". "PRN:", and "AUX" for the cur- These files contain machine lan- rent console, printer and modem guage instructions. card. zap:zap:zap:zap: a ZAP is a modification to DOS:DOS:DOS:DOS: Disk Operating System a program or data file. When used as a verb, "to zap" means dump:dump:dump:dump: the display of a file on to alter or modify a file. a printer or screen in both hex- adecimal and text format. Glossary 47 PC-ZAP User's Guide PC-ZAP User's Guide PC-ZAP User's Guide PC-ZAP User's Guide INDEX _____ abort prompt 21,22,23,24,25,26 DISKCOPY 47 address 9,13 distribution package 1,2,8 AMASPZAP iv documentation iii,iv,1-3 apply, definition 47 DOS iii,1-3,8,10,12,24 ASCII iii,6,8,14 DUMP command 14 assembly listings 13 errors 23,25,28,30 asterisk 8 location of command 8 AUX device 47 use with REP command 17 use with VER command 18 backup 1,11,31 samples 32,38,40 BASE command 13 dumping screen graphics 38 errors 28,29,30 location of command 8 EasyWriter 34,35 use with REP command 17 editor 8,42,43,45 use with VER command 18 END command 15 samples 32,38,40 errors 29,30 BASIC 2,8,24,47 use of command 4,5,11 batch mode 8,29 ENTER key 4,6,7,11,29,36 BIOS 32,41 error messages 20-30 boot 1 display of 7,41,42,43,44 break key 4,11,14,22,29 replying to 21 buffers 15 error switch (see "NOGO switch") byte 6,14 EW 34,35 EXE files iii,13,14,16,32,33, carriage return 3,6 40-46 CHDIR command 8 exit 5 color attribute 42,43 extension 6,7,47 COM files iii,1,8,9,10,11,14,16, 17,18 file name 14,16,19,23 COM1 device 7,47 floppy disk 2,31,32,34,36,38,40, comma 23,25 43,45 comments 8,13,14,16,17,18,19 FORMATV.ZAP 36,37 compatibility 1 compilation listings 13 GEMGRAPH.ZAP 38,39 completion codes 22 Gemini printer 38 CON device 6,7,19,21,29,47 Glossary 47 console 7,47 GRAPHICS.COM 38,39 corrections 2 creating zaps iii,8 hexadecimal iii,6,13,14,17,18, ctrl key 4,6,11,14,22,29 28,29 current directory 14,16,24 cursor 3,42,43,44 IBM88VMI.COM 34,35 identifier 20 damaged disks 26 Ignore prompt 21,22,23,24,25,26 DEBUG iii Index 48 default drive 24,33,35,36 input file 6,7,19 default operands 6,7,19 interactive mode iii,6,11,14,15, delete 25 29 device 7,20,22,24,25,47 interrupting the program 11,14, digits 13,17,18,20,28,29,47 22,29 directory 8,14,16,24 Invocation 4,6,8,11,19 disk types 2 Index 48 PC-ZAP User's Guide PC-ZAP User's Guide PC-ZAP User's Guide PC-ZAP User's Guide INDEX _____ key 4,11,14,22,29,39,45 picture 39 keyboard 6 PRINT command 2 printing a dump 14 label 36 printer 2,3,7,22,23,24,25,38,39, LINK 14,16 41 listing file iii,2,6,7,19,24,25 printer name 47 listings 13 PRN device 47 location 9,27,47 problems 20,23,24,26 logo 45 prompts 3,4,7,11,20-26,29,33,36, Lotus-123 32,33 45 LPT1 device 7,25,41,47 protected software 1,25,26,31, 32,34,40 MemoryShift 40,41 PrtSc key 39 messages, see "Error messages" mode iii,1,3,6,8,11,14,15,29 quick summary 19 modem 7,47 quit 19 modification iii,47 RAM 2 modified iii,4,33,35,37,39,41, rebooting 15,25 44,46 recovering from errors 20,21 modify 32,34,36,38,40,42,45,47 REP command 17 module 18,32,34,35,36,38,40,42 errors 27-30 multiple zap files 10 location of command 8 use with BASE command 13 NAME command 16 use with VER command 18 errors 23-25,27-30 reply 25,26 location of command 8 reset 10,17,18,27,28,29 overrides PC-ZAP command 6,7 restrictions 1,24 use with REP command 17 retries 26 use with VER command 18 Retry prompt 21,22,23,24,25,26 NOGO switch 10,17,18,22-25,27, 28,29,30 sample zap files 31-46 Scroll-Lock key 11 offset 13,17,18,19,27,28,29,47 sectors 1 open 26 semicolon 7,33,47 order of commands 8,12 sequence of commands 6,10,30 OS iv serial port 7 output file 6,19 Service Aids iv output 2,6,7,14,22,23,24,25 size of files 13,28 overprinting 3 space 25 override 6,7 spelling 23,24,25 spreadsheet 33 paper 3,23 Star Micronics 38 pathnames 8,14,16,27 startup 3,4,8 See also "Directory" string 13,14,16,17,18 PC-ZAP command 1,3,6-8 structure of a zap 19 PC-ZAP.DOC 1,2 switch 3,10,17,18 PC-ZAP.EXE, see "PC-ZAP command" PE.EXE 42,43,44,45,46 tab 26 PECOLOR,ZAP 42,43,44 terminating PC-ZAP 4,11,15,21, PELOGO.ZAP 45,46 22,27,29,30 Personal Editor 42-46 text files 6,8,42,43,47 period 47 TYPE command 2,3,11,20,21,31,32, Index 49 PC-ZAP User's Guide PC-ZAP User's Guide PC-ZAP User's Guide PC-ZAP User's Guide INDEX _____ 34,40,47 volume 36 VS2 iv undoing a zap 9 unprotecting software 32,34,40 wait 15,45 VER command 18 XT iii,2 errors 22,27,28,29 location of command 8 zap files 8-11 use with BASE command 13 ZAP000I message 5,15,22 use with NAME command 16 ZAP091E message 10,27,28 use with REP command 17 zero 28,47 Index 50